Worklog3a³ Activity logging program for Psion Series 3a³ (c) Alfa Computing 1996³ Richard Schmidt³ Richard Sturenberghlaan 50³ 2273 GX VOORBURG³ THE NETHERLANDS (EUR)³ Email @ Compuserve : 100735,331³ Email @ Internet : 100735.331@compuserve.com³ ³ Version V1.1.0³ 12/04/96³ Index ===== 1. INTRODUCTION 2. INSTALLATION 2.2 REQUIREMENTS 2.3 HOW TO INSTALL 2.4 DISTRIBUTION 3. KEYBOARD REFERENCE 4. THE AUTHOR 4.1 HOW TO CONTACT THE AUTHOR 4.2 DISCLAIMER 4.3 HOW TO REGISTER 5. FUTURE DEVELOPMENT 1. Introduction =============== Welcome to WorkLog3a! WorkLog3a is a project activity logging program. It can log activities for specific projects during a work day and save time spend on these activities to a database. This program can be useful for people working on several projects having to monitor their labour and creating time-sheets. Features of WorkLog3a: - input of projects and recording activities for this projects. - calculation of: * total work hours per project within a specific period, and all projects cumulated; * total work hours per project today; * total work hours per project in a; specific week; totals are specified per day; * available and remaining budget; - memo per project; - notification when exceeding workday hours - (audible)notification when activity has expired on user specified duration forcing application to come to foreground; - printing projects and its activities/totals; - tracking remaining vacation hours - and lots of other stuff... WorkLog3a is only available in English for the Psion Series 3a. 2. Installing WorkLog3a ======================= Before using the application you should install it from your PC to your Psion. 2.1 Requirements ================ The application requires 75K RAM memory and approximately 50K ram of disk space. If your machine appears to be out of memory try to close a few applications or erase files from internal memory (after making a backup first!). 2.2 How to install ================== To install WorkLog3a: - start RCOM or MCLINK; - connect and switch on Psion link in system screen with Psion-L; - copy file WORKLOG.OPA to an \APP directory on any disk - copy file WORKLOG.HLP to an \APP\WORKLOG directory on any disk. - Create directory \WORKLOG\ on any drive and copy EXAMPLE.* to this directory. These files contains an example projects file. - Install the WorkLog3a application in the system screen by pressing Psion-I. Make sure you have an \OPD directory on your default drive. WorkLog3a will save its configuration to \OPD\WORKLOG.INI. 2.3 Distribution ================ An unregistered copy of this application may be distributed freely. The application itself consists of the following files: WORKLOG.OPA Main application WORKLOG.HLP Help screens MANUAL.TXT This manual HISTORY.TXT Changes since initial version EXAMPLE.WKL ! EXAMPLE.WKI ! files for example EXAMPLE.WKT ! 3. Keyboard reference ===================== File - Open - Psion-O --------------------- Opens new projects file. A projects file contains project descriptions and all the activities. A projects file consists of two files and optionally some memo files: \WORKLOG\EXAMPLE.WKL projects \WORKLOG\EXAMPLE.WKT descriptions \WORKLOG\EXAMPLE.WKI project info \WORKLOG\EXAMPLE\*.WKM memos for EXAMPLE File - New - Psion-N --------------------- Create new projects file. New files will be stored in the \WORKLOG\ directory. File - Tidy up - Psion-K ------------------------ This option can be used to tidy up the activities file. All activities for all projects will be removed before a specific date. Search - Find - Psion-F or F ---------------------------- Find project in list. Searches through projects and makes an occurrence current project. Search - Find next - Psion-G or G --------------------------------- Find next project in list. Searches from current project to end. Search - Jump - Psion-J ----------------------- Jumps to project by number. Every project in the list is preceded by its record number. Use jump to jump to a project by entering this record number. Search - Jump - Esc ------------------- Bring up speed list, jump to project Project - Enter - Psion-E ------------------------- Add a new project to the project file. A maximum of 1000 projects can be entered. The unregistered version of WorkLog3a allows for 5 projects. PROJECT - short description for project DESCRIPTION - long description for project CHARGE/HOUR - internal charge per hour, this information is used to determine the remaining budget. BUDGET - budget (money value) for this project Project - Enter - Psion-U or ENTER ---------------------------------- Update current project. Updated project are always moved to the end of the list. Project - Delete - Psion-D or DELETE ------------------------------------ Delete current or marked projects. Project - Info - Psion-I ------------------------ Display information about: 1. number of projects in current project file 2. number of activities for ALL projects 3. number of activities for CURRENT project Project - Memo - Psion-+ ------------------------ Create or edit memo for current project. Each project can have one memo. This option launches the built in WORD application. Therefore memos are limited to 40000 characters. Memos are stored in a subdirectory (with same name as projects file) in the directory that contains the project files (usually \WORKLOG\). The names for the memo files are equal to the internal project id number (invisible for user). Be aware when renaming a projects file to rename also the memos subdirectory. Project - Mark current - Psion-M -------------------------------- Mark current project. Marked projects can be deleted in one pass. All reports on screen or printer apply to either ALL projects or MARKED projects. Project - Mark all - Psion-A ---------------------------- Mark all projects. Project - Unmark all - Shift-Psion-U ------------------------------------ Unmark all projects Activity - Start - Psion-S, S or SPACE -------------------------------------- Start activity for current project. Depending on the setting a dialog box appears (at the end or start of activity) querying the description for the activity. During the activity a dialog box is displayed showing the elapsed time and remaining duration time. The duration of an activity acts as a countdown timer for activities. Depending on the settings, an activity can be stopped automatically forcing WorkLog3a to come to foreground and beep optionally. WorkLog3a allows for a maximum of 3000 activities per projects file. Activity - Manual entry - Shift-Psion-M --------------------------------------- Add activity to activity database manually without having to start (record) an activity. This option can be used when you "forgot" to start a new activity and want to add it afterwards. It is possible to enter: - a period with start and end date; - a duration with start date and a duration of 15min, 30min, 1hr, 2hrs, 4hrs or 8hrs. Activity - View - Psion-V or TAB or Shift-TAB --------------------------------------------- List all activities for current project. This dialog shows descriptions, start/end date and start/end time for all activities. Shift-TAB shows all activites for all projects Psion-U or Enter Update activity Psion-D or Delete Delete activity Psion-S Sort activities Psion-F Find activity Psion-G Find next activity Psion-P Move current activity to other project. Select project from list to move activity to Esc Close activity list Help Help Menu Menu Activity - Categories - Psion-C ------------------------------- Every activity has a desciption. Categories can be used as descriptions for these activities. A maximum of 10 descriptions can be entered. Activity - Categories - Psion-V ------------------------------- Update remaining vacation hours for this year. It is possible to add or substract hours. remaininghours=remaininghours+add-subtract Totals - None - Psion-- ----------------------- Stop display of totals in project table view. Switching off totals speeds up scroling. Totals - Period - Shift-Psion-P ------------------------------- Calculates total labour per project in a specific period. If projects are marked than only marked project will be calculated. Totals - Day - Shift-Psion-D ---------------------------- Calculates total labour per day for a maximum of 7 consecutive days starting at a specific date. Totals - Week - Psion-W ----------------------- Calculates total labour per day in a week. The number of working days (1-7) in a week depends on your settings in the preferences dialog (default 5). Totals - Today - Psion-* or * ----------------------------- Calculates total labour today. Totals - Remaining budget - Psion-B ----------------------------------- Calculates remaining budget per project. Uses budget and charge/hour specified with project. Totals - Set filter - Shift-Psion-F ----------------------------------- Normally the calculation of totals applies to all activities. By setting a filter, only activities with same description as filter will be taken in account when calculating totals. Special - About - Shift-Psion-A ------------------------------- Displays about information. Special - Register - Psion-R ---------------------------- Register your copy of WorkLog3a. Special - Set preferences - Psion-Q ----------------------------------- Set global preferences. These preferences are devided over two pages. TIME FORMAT - time format for displaying and printing time. WORK DAY - length of workday in hours. Used to determine when workday hours are exceeded. START OF WORK DAY - start time of work day used for default time for manual entries. WORK DAYS PER WEEK - number of work days per week. When making a report for working hours in a week. DEFAULT CHARGE FOR NEW PROJECTS - default charge per hour used when entering new projects. DEFAULT BUDGET FOR NEW PROJECTS - default budget used when entering new projects. WORKHOURS NOTIFICTION - totals for today are calculated when an activity has stopped. DEFAULT TIME FOR MANUAL ENTRIES - option for setting default time when entering manual activities. Selectable system time or start of work day time. PROMPT FOR DESCRIPTION - prompt for description when starting or stopping a task. Three types of prompt are available: - Do not ask; - Before starting; - When stopping. DEFAULT ACTIVITY DURATION - default activity duration for new activities. Depending on setting the activity will continue or terminate after this time has elapsed. It's also possible to select an audible warning. ON EXPIRATION DURATION - determines what action to take when activity duration has elapsed. (see setting above) Settings are saved to \OPD\WORKLOG.INI Special - Zoom in - Psion-Z --------------------------- Enlarge screen font used for displaying projects. Special - Zoom out - Shift-Psion-Z ---------------------------------- Reduce screen font used for displaying projects. Special - Print setup - Psion-Y ------------------------------- Select between printing to file or parallel port. LINES/PAGE - maximum lines per page for work hours reports. HEADER - text header to appear on top of each page. Special - Print - Psion-P ------------------------- Print totals for period, week or subsequent days. Set "Include activities" to yes if all activities are to be printed as well. Special - Exit - Psion-X ------------------------ Exit application. 4. The author ============= 4.1 How to contact the author ============================= The author can be reached by mailing to: Alfa Computing Richard Schmidt Richard Sturenberghlaan 50 2273 GX VOORBURG THE NETHERLANDS (EUR) Email @ Compuserve : 100735,331 Email @ Internet : 100735.331@compuserve.com 4.2 Disclaimer ============== The author takes no responsibility for any lost data or hardware malfunctions of any kind due to the use of this software or any other software that ships with WorkLog3a. 4.3 How To register =================== - send cash in envelope to my postal address or - use SwReg on compuserve to register SWReg id : 10384 Product : WorkLog3a Price : $20 or equivalent - Only for Dutch users Stort voor registratie Hfl 35,-- op girorekening 6338889 tnv R.G.Schmidt te Voorburg o.v.v. uw adresgegevens. ********************************** * registered PTM3a users receive * * a free update * ********************************** OTHER SOFTWARE : CALC3a and TRIPS3a 5. Future development ===================== - export to ASCII; - client information per project; - table view of activities; - sorting activities on date; - maximum labour per project; - tidy up, move (marked) activities to other projects file. etc.